[deprecation] Deprecate AddReturnArrayDocblockBasedOnArrayMapRector - #8342

Deprecate AddReturnArrayDocblockBasedOnArrayMapRector, as too niche and of little practical value.

The rule only fires when array_map() gets an inline closure or arrow function with an explicit return type. In that case the item type is already written right there in the code, and static analysis infers it without any docblock:

 class SomeClass
 {
+    /**
+     * @return int[]
+     */
     public function getItems(array $items)
     {
         return array_map(function ($item): int {
             return $item->id;
         }, $items);
     }
 }

The realistic cases - a callable string, a first-class callable, a method reference, or a closure without a return type - are all skipped, so the rule adds a docblock only where it is least needed.

Changes:

• rule implements DeprecatedInterface and throws on refactor()
• removed from TypeDeclarationDocblocksLevel
• tests and fixtures removed